home *** CD-ROM | disk | FTP | other *** search
/ Acorn User: China / Acorn User China CD-ROM (UK) (Disc B) / Acorn User China CD-ROM (UK) (Disc B).bin / WEBSITES / FORTRAN_FRIENDS / FF1.ZIP / Readme < prev    next >
Encoding:
Text File  |  1996-10-17  |  8.3 KB  |  189 lines
  1.                        FORTRAN PUBLIC DOMAIN LIBRARY
  2.                              Version 2.01  
  3.  
  4. This is a PD library. If you wish to redistribute any of these files in
  5. any way, please include an acknowledgement to the 'Fortran Friends'
  6. ShareWare library and include the relevant copyright notices in the
  7. documentation files. Please read these notices carefully; some of the
  8. libraries forbid their sale for commercial gain.
  9.  
  10. The Fortran compiler is not on this disk.
  11.  
  12. Fortran Release 2 for Acorn computers is available for £99 (ex VAT) from:
  13.  
  14.  Intelligent Interfaces Ltd,     Tel.  (01703) 261514 
  15.  P.O.Box 80,                     Fax.  (01703) 267904
  16.  Eastleigh, 
  17.  Hants SO5 5YX, UK.
  18.  
  19. Further contributions which complement the existing collection are welcome.
  20. Please send your compiled libraries to add to this library, and/or the
  21. source code if you prefer, to the address below; I shall then send you an
  22. updated version of this library disc. Information on bugs you have found,
  23. sources of PD libraries etc. are also most welcome. Join the self-help
  24. 'Fortran Friends' group now! 
  25.  
  26. Routines must be your own copyright, accompanied by a text file describing
  27. briefly what the routine does, defining the parameters, and any error
  28. returns. You must include a copyright notice giving your name and address
  29. so that users can contact you if they have any queries. No attempt will be
  30. made to fix any problems in your routines, nor remove duplicate entry
  31. points. However, test programs should be provided where possible, so that
  32. their execution on the Archimedes can be checked.
  33.  
  34.  *************************************************************************
  35.  
  36.                    Disk FFriends_1 Contents  17 Oct 1996
  37.  
  38.    From D.J. & K.M. Crennell (unless otherwise indicated)
  39.  
  40. 1. !Fortran77
  41.       A desktop tool allowing compilation, linking, and execution. This 
  42.       does NOT include the fortran compiler nor the linker; it can be used
  43.       with release 2 (and the ASD debugger if you wish), or you may use the
  44.       recently released Acorn DDE with its revised linker. The text file
  45.       'Instruct' within the !Fortran77 application directory gives setup and
  46.       running instructions.
  47.  
  48.    (An improved version of this which uses windows rather than menus
  49.     is marketed by Intelligent Interfaces, see address above).
  50.  
  51.    The following libraries are written in Assembler for speed. Since most
  52.    people have neither the Assembler, nor the library making utilities, the
  53.    Assembler source is not included.
  54.  
  55. 2. Binario (added 15 Jan 1992)
  56.    Fast binary input/output, callable from Fortran, as used by "Interacter"
  57.    from Interactive Software Services and supplied by Lawson Wakefield.
  58.  
  59. 3. Graphics
  60.    33 Graphics Routines which emulate the similar BASIC commands
  61.       e.g.    CALL LINE(IX1,IY1,IX2,IY2)
  62.  
  63. 4. SpriteOp
  64.    44 Sprite_Op routines for all the SpriteOps
  65.        names of the form SPOPnn, 02 < nn < 62
  66.  
  67. 5. Utils
  68.    11 Utilities e.g. J = IGET()  simulates the BASIC GET command, and a
  69.        general SWI calling routine (updated for StrongARM).
  70.  
  71. 6. Wimp
  72.    51 Wimp routines covering all wimp operations + some utilities.
  73.  
  74.    There are fortran test programs using these libraries called Tdraw
  75.    TGraphics, TSpriteOp TUtils and Twimp. There is no documentation
  76.    for these other than the comments within the programs which are
  77.    not intended as tutorials, just implementation tests.
  78.  
  79. Fortran source libraries contributed.
  80.  
  81.     Only the source and documentation are supplied in directories f77 and
  82.     docs. To create libraries, compile the routines and move the aof to the
  83.     'lib' directory, see the file '!Fortran77.Instruct' for details.
  84.  
  85. 1.  DrawF
  86.     A set of utilities to create Draw files for 'path' and 'text' objects.
  87.  
  88. 2.  Graphdemo (added 31 Dec 91)
  89.     A set of utilities to plot a line graph through a set of X,Y points
  90.     with axes labelled with 'nice' values. The demo reads the points from
  91.     a file (called 'GraphData', not supplied), and plots the graph within a
  92.     window set by the user. The GraphData file has an x and a y on each
  93.     line, read with free format input. It has only been tested from a
  94.     non-WIMP program, and needs a little work to be usable from the WIMP.
  95.     The Drawfile GrfDemCons demonstrates the layout and meaning of the
  96.     variables. The only other documentation is in the source code comments.
  97.  
  98. 3.  ACMToms (added 17 Jan 92)
  99.     Various algorithms supplied by C.Johnson, originally part of the ACMToms
  100.      (See Readme in that directory for further information). Adapted to run
  101.     on RISC-OS by K.M.Crennell using the 'Fortran Friends' libraries.
  102.  
  103. 4. ARTlib (added 19 Feb 93)
  104.     Library of utility routines which simplify free format input, supplied
  105.     by A.R.Thawley, (see Library.Docs.ARTReadMe for further information)
  106.  
  107. Fortran applications
  108.  
  109. 1. SphereRot (added 7 Dec 91)
  110.    An example of the use of SpriteOps for the manipulation of objects made
  111.    of spheres. (Not Desktop)             
  112.  
  113. 2. WimpPoly vers 2.34 (added 7 Dec 91; updated for StrongARM August 1996)
  114.    An example of the use of Wimp routines called from Fortran to display
  115.    polyhedra from pre-stored datafiles. (There is not room for all the
  116.    datafiles on the !Fortran77 disc, they can be found on another ShareWare
  117.    disc.)
  118.  
  119. Advice for converting a Basic program to Fortran (with example).
  120.  
  121. List of reported bugs in Fortran77 release 2.
  122.  
  123. List of commercial suppliers of libraries callable from fortran.
  124.  
  125. List of bulletin boards accessible from the Joint Academic Network.
  126.  
  127. List of names and addresses of 'Fortran Friends'
  128.  *************************************************************************
  129.  
  130. The distributed disc (FFriends_1 )structure is:
  131.  
  132.     $.Readme       (this file)
  133.      .Bas2F77      (instructions for converting Basic to Fortran)
  134.      .TCircles     (simple Basic program for use with instructions above,
  135.                     the converted program is library.f77.Tcircles)
  136.      .F77Buglist   (List of reported errors in Fortran77 Release 2, with
  137.                    example code)
  138.      .F77LibList   (List of commercial suppliers of Fortran libraries)
  139.      .PDInfo       (List of software libraries accessible from JANET) 
  140.      .!Fortran77   (the front end RISC-OS application with documentation)
  141.      .!SphereRot   (application, see its 'ReadMe' file for instructions)
  142.      .!WimpPoly    (application, see its 'ReadMe' file for instructions)
  143.      .ACMToms.     (ReadMe & Copyright notice)    
  144.              .f77  (directory of Fortran algorithms)
  145.      .library.
  146.              .docs (directory of documentation, one file for each library)
  147.              .f77  (directory of fortran source, example programs)
  148.              .lib  (fortran libraries)
  149.  
  150.  *************************************************************************
  151.  
  152. INSTALLATION INSTRUCTIONS FOR HARD DISK OWNERS
  153.  
  154.  1. It is assumed that Fortran77 is already installed on your system.
  155.  2. Copy the library files in the disc FFriends_1.$.library.lib directory to
  156.     the .lib directory of your Fortran installation. 
  157.  3. Copy the application !Fortran77 to any suitable directory where you 
  158.     store your utility programs.
  159.  4. Read the documentation files, !Fortran77.Instruct, and those in the
  160.     directory library.docs
  161.  
  162.  *************************************************************************
  163.  
  164. INSTALLATION INSTRUCTIONS FOR MAKING A WORKING FLOPPY DISK VERSION 
  165.  
  166.  1. Format an 800K floppy disc. 
  167.  2. Create new directories $.Library, $.Library.lib and $.f77
  168.  3. Copy from your Fortran77 system disc the files f77fe, f77cg, and link to
  169.     the Library directory of the working floppy.
  170.  4. Copy from your Fortran77 system disc the F77 library 
  171.     (name Library.lib.f77) to Library.lib.f77 on the working floppy.
  172.  5. Copy the library files in the disc FFriends_1.$.library.lib directory to
  173.     the directory Library.lib on the working floppy. 
  174.  6. Copy the application !Fortran77 to the top directory of the working 
  175.     floppy, then delete the file !Fortran77.Instruct from the working floppy     to save space.
  176.  7. Read the documentation files, this file, !Fortran77.Instruct, and those
  177.     in the directory library.docs.
  178.  8. Copy the Fortran program you want to compile into the $.f77 directory of     the working floppy.
  179.  9. Load the FPEmulator module from your Fortran77 system disc.
  180.  
  181.   Your working disc should then be ready to run. 
  182.  
  183. Enjoy it!
  184.  
  185.                K.M. Crennell
  186.                P.O. Box 64,
  187.                Didcot,
  188.                Oxon, OX11 0TH.
  189.